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CHAPTER 1 Crunchit Overview 



Crunchit is the most advanced compression utility available for Microsoft Pocket 
PC devices. It offers unparalleled ease-of-use, security features and supports more 
file formats than any other package. 

Supported file formats 

Crunchit allows you to exchange files with Windows, Macintosh, UNIX and other 
handheld computers. It supports ZIP (.zip), SFX (*.exe), UUE (multipart with stan- 
dard and base64 encoding), JAR (.jar), TAR (.tar), GZIP (.tar.gz, .tgz) and BZIP2 
(.bz, .bz2, .tbz, .tbz2) file formats. 

Automate complex tasks 

Crunchit provides seamless integration with Microsoft File Explorer and other 
Pocket PC applications. In three taps you can open an archive, select and view a file 
in the associated application. Or you can automatically open em archive in Crunchit 
by double tapping it in Microsoft File Explorer. 

Send files fast, safe and secure 

Use Crunchit to compress your files and reduce transmission time. You can also 
secure files with Crunchit to prevent unwanted visitors ftom snooping through your 
files. 
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Crunchit Overview 



An excellent backup tool 

Crunchit makes it easy to move files in and out of archives. You can add or move 
entire folders into a ZIP file based on age or name (for example, *.doc). Extract 
files with the peace of mind that you will not erase something important. 



Advanced navigation 

Manage and work with large archives. The file browser displays file information in 
a compact, sortable and color coded format. See relevant statistics 'size and disk,' 
plus much more. 

Create self-extracting ZIP files 

Crunchit is an essential tool for software developers. It enables you to create self- 
extracting ZIP files (*.exe) for ARM, XScale, MIPS, SH3 and X86 emulator 
Pocket PC devices. Software deployment has never been easier! 

Benchmark your Pocket PC 

See how fast your Pocket PC really is. For enthusiasts and reviewers, use Crunchit 
to benchmark the performance of your processor and storage devices. 
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CHAPTER 2 — What's New? 



Crunchit version 4.X introduces many new features to help users navigate archives 
and work with more compression formats. 

Windows Mobile (Pocket PC 2003) SFX support 

Create self-extracting (SFX) files that automatically unzip themselves on Pocket 
PC 2000, 2002 and Windows Mobile devices. 

UUEncode/Decode 

Crunchit lets you create and decode multipart UUE files (including the latest 
base64 format) so you can send and receive files from newsgroups, email and other 
Internet services. 

New file dialogs with multi-select capabilities 

The Crunchit file dialogs now use the compact "look and feel" with multi-select 
capabilities. These features let you work faster and be more precise when you Eire 
adding files and folders to archives. 
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What's New? 



Work smarter 

We're listening. The latest version of Crunchlt lets you hide passwords and move 
the current archive to SFX (ZIP only) or UUE in a few taps. 
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CHAPTERS System Requirements 



Below are the minimum requirements your handheld needs to run Crunchit: 

• XScale, ARM, MIPS or SH3 processor 

• Color or monochrome display 

• Microsoft Pocket PC 2000/2002/2003 operating system 

• 1 megabyte (MB) of storage space for application data; 2 MB or more for tem- 
porary and archive data recommended 

• External memory cards and storage devices are supported 

New Pocket PC devices are being introduced all of the time. If you are unsure if 
your handheld satisfies the above requirements, try installing Crunchit or contact 
support@nsctech.com. 



Crunchit User Guide 



5 



System Requirements 



Crunchit User Guide 



CHAPTER 4 Installation Notes 



NOTE: It is recommended that you perform a "soft" reset of the device after 
installing Crunchlt. Refer to your handheld manual for further details. 

Desktop computer to device 

1 . Using Microsoft Windows Explorer on your desktop computer, change to the 
"Crunchlt" folder and open (double-cUck) the Setup.exe program. 

2. Click the Install button. 

3. Read the license agreement carefully. If you agree to the terms, click the Accept 
button to continue. Otherwise, cUck Decline and remove Crunchlt from your 
computer. 

4. The Crunchlt setup program will launch Microsoft ActiveSync. You will be 
prompted to install (or re-install if you are upgrading) Crunchlt. Click Yes to 
continue and follow any additional instructions from ActiveSync. 

5. Verify Crunchlt has been installed on your device by looking for the green 
Crunchlt icon in the "Programs" folder (Start > Programs). 

Desktop computer to device, device to device or web to device 

1. Locate the .CAB file for your device (for example, CrunchIt.PPC3_ARM.CAB 
for XScale and ARM devices) found in the "Crunchlt" folder. 
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Installation Notes 



2. Using Microsoft Windows Explorer or another data transfer application, copy 
the .CAB file to the "My Documents" folder on your device. For example, if 
you are using Microsoft Windows Explorer, drag the .CAB file into the 
"Mobile Device" folder (located in the tree view). 

3. Using Microsoft File Explorer (Start > Programs > File Explorer) on you 

device, navigate to the "My Documents" folder. Tap the .CAB file to install 
Crunchlt. 

4. Follow any instructions that may be presented to you. 

5. Verify Crunchlt has been installed on your device by looking for the green 
Crunchlt icon in the "Programs" folder (Start > Programs). 
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CHAPTER 5 Configuring Crunchlt 



Crunchit provides many options to help you navigate archives and adjust compres- 
sion settings. To configure Crunchlt, select the Settings option in the Tools menu. 



Configure General settings 



121 Crunchlt 



Default Folders - 



12:41p iSEl 



Open : |\My Documents\ 
Eiitract : |\My Documents\ 
Add : |\My Document;\ 



Prompt 

W\ Conlirm delete file(s) 
W\ Close dialogs when complete 
0 Benchmark ZIP operations 
0 Hicfa password 



General | Compresaon 

File Edit Tools & [0] M H|* 



1. Open folder. Enter the default archive folder. 
Crunchlt will always look for files in this location. 

2. Extract folder. Enter the default extract or tempo- 
rary folder. 

3. Add folder. Enter the default folder for add opera- 
tions. 

4. Confirm delete prompt. Check this option if you 
want to Crunchlt to ask you if it is okay to delete any 
files or folders. 



5. Close dialogs. Check this option if you want to 
automatically close status dialogs. 

Benchmark ZIP operations. For registered users, this option will display a sta- 
tistics dialog after all ZIP operations. See the "Benchmarking ZIP operations" 
section below. 

Hide password. Enable this option if you want to mask passwords during ZIP 
operations. 
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Configuring Crunchit 



5. 



6. 



gj] Crunchit 



l:56p @ 



I I Overwrite existirng file(s) 

0 Skip older file(s) 

1 I Ignore path information 



Configure Compression settings 

1. Overwrite existing files. Check this option 
if you want the files and folders in the current 
archive to always overwrite the ones on your 
device. WARNING: This option will override 
the Skip older file(s) option and may delete 
any changes you have made to existing files. 

2. Sltip older files. Select this option if you 
want Crunchit to preserve newer files on your 
device. 

3. Ignore path information. Check this 
option if you want to ignore the folder hierar- 
chy in the current archive. 

4. Refresh older files. This option will 
update the files in your archive. 

Move files to archive. Select this option if you want Crunchit to delete the files 
on your device after they have been moved into the archive. 

Compression level. Adjust the pointer to the compression level that suits your 
needs. No or fast compression levels will take less time, but result in larger 
archives. 



Add 

0 Refresh older file(s) 

1 I Move flle(s) to archive 
Compression : 



lenefaTI Compression | 
File Edit Tools |3 ^ 



10 



Crunchit User Guide 



CHAPTERS Using Crunchit 



Opening archives 

There are two methods to open an archive with Crunchit: 
Microsoft File Explorer 

Open Microsoft File Explorer (Start > Programs > File Explorer) and browse to 
the folder where you store your archive files. Single-tap a ZIP, SFX, TAR, GZIP, 
BZIP2 or JAR file. If Crunchit is not already open, it will automatically launch the 
file you have selected. 

Crunchit 

Open Crunchit (Start > Programs > Crunchit) and select the Open Archive 
option in the File menu, or single tap the folder icon on menu bar. The 'Open' dialog 
will be displayed. 

The Open dialog allows you to access the archives on your device. If you want to 
change folders, double-tap an entry in the folder view or select an entry in the 
'Folder' drop-down box. You can filter archives with the 'Type' options; and sort 
based on name, size, type and date. To open an archive, double tap an entry in the 
file view, or select it and tap the 'Open' button. 
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Using Crunchit 



Navigating archives 

After opening an archive, Crunchit will 
display the type, name, date, size and path- 
name of each file entry. Remember that 
some file formats, such as GZIP and BZIP2 
will only contain a single file. The software 
includes several unique features to help 
you navigate this information: 

•The file entry information can be sorted 
by clicking on the header. The sort column 
is color highlighted to serve as a reminder 
of the current position. 

•Using the checkbox on the menu bar, or 
the Multi-Select option in the Edit menu, 
it is possible to single tap to select file 
entries. 

•Tap-and-hold on the file entry view to 
display a short-cut menu. Relevant file 
operations and selection commands are available through this menu. 

• Double-tap a file to extract and launch it in the associated Pocket PC applica- 
tion. For example, you can double-tap a word processing document to load it in 
Pocket Word. 

• To e-mail files with Pocket Outlook, select one or more files and choose the 
Mail File(s) option in the Edit menu. 

• To display extended file attributes, such as the 'size on disk', select a file entry 
and then use the File Properties option in the Edit menu. 

• To search and select files, choose the Find option in the Edit menu. Enter a 
name pattern (all UNIX wildcard options are supported, such as ?, * and !). 



Testing and extracting files 

To extract files from an archive, select the Extract option in the Edit menu; or 
click the arrow icon on the tool bar. The 'Extract File(s)' dialog will be displayed; 
containing options to change the destination folder of the files, overwrite mode and 
selection criteria. Tap Extract to decompress and write the contents of the files. 
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Working with ZiP fiies 



If you wish to test the integrity of an archive or specific files, use the Test option 
found in the Edit menu. Crunchlt will decompress and check the file data without 
writing the contents. 

If one or more of the files in the archive is protected with a password, Crunchlt will 
prompt you for a password to unlock the contents. 

The default file selection behavior of test and extract is as follows. If no files are 
selected the operation will apply to all files, otherwise selected files will be used. 



Working with ZIP files 
Creating new ZIP files 

To create a new ZIP archive, select the New Archive option in the File menu. The 
"New ZIP' dialog will be displayed; where you can enter the name and location of 
the new archive. Note that do not need to add the '.zip' extension to the name, 
Crunchlt will add it for you. Tap Create or press return to edit the new archive. 

Adding files 

To add files to a ZIP archive, select the Add option in the Edit menu or tap the plus 
icon on the tool bar. The 'Add File(s)' dialog will be displayed; containing options 
to select the files or folders to be compressed. If you select a folder, the add opera- 
tion will apply to all of the files and sub-folders contained in it. A file mask option 
is available to add files of a specific name or type. For example, '*.doc' will cause 
Crunchlt to only add word processing documents to the archive. Tap the Add but- 
ton to add the selected files and folders to the archive. 
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Securing files with a password 
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To encrypt files with Crunchit, you must enter a 
password before adding items to the ZIP file: 

• Select the Password option in the Tools menu. 
•Enter a password and tap 'OK' to continue. 
•Add (Edit > Add) files to the archive. 

NOTE: Crunchit uses the ZIP 2.0 encryption 
standard (Windows, Unix and Macintosh com- 
patible) to encode files. 



Deleting files 

To delete files fi-om an archive, select one or more entries in the file view. Choose 
the Delete option in the Edit menu or tap the 'X' icon in the menu bar. 

NOTE: Users have reported that the delete operation will fail on some storage 
cards and devices. This is a bug in the operating system/device driver If you are 
experiencing problems, you should move the file off the storage card, perform the 
delete operation and then move it back. 



Benchmarking ZIP operations 

NOTE: This feature is for registered users. 

Crunchit includes a benchmarking tool for measuring the performance of your 
PDA's processor and storage devices. 

To benchmark the performance of ZIP operations, check the Benchmark ZIP 
operations option in the General settings (Tools > General). 



14 



Crunchit User Guide 



Creating self-extracting ZIP files 



NOTE: If you turn on the benchmarking feature, you will have to close the current 
ZIP file and re-open it to gather performance statistics. 



Stream statistics 

The inflate/deflate statistics display the amount of time (seconds) the processor 
spends performing dictionary lookups, bit shifting/arithmetic and read/write mem- 
ory operations. If the data is encrypted, additional CRC calculations and arthimetic 
are included. These measurements do not account for the time taken to read or write 
to the file system. 



File statistics 

The read/write statistics display the amount of time spent reading and writing data 
from the storage device. 



General statistics 

The archive statistics display the amount of time spent processing the archive for- 
mat datastructures. It does not account for the time taken to update the Crunchit 
user interface or threading overhead. 



Creating self-extracting ZIP files 
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Create self-extracting file from : 
|\My Doci-iment^\te;t.zip 



Select thie destination device(s) : 
W| 0 ARM Q SH3 

□ MIPS □ XS6 EM 



Cancel 



The first step in creating a self-extracting ZIP file is to 
create a regular ZIP file with the files and folders you 
want included in the final executable. 

NOTE: Do not use a password in your ZIP file, the self- 
extracting component does not support encrypted ZIP 
files. 

After you have created your ZIP file, select the Create 
SFX option in the Tools menu: 



1. Tap the Browse button and select the source ZIP file. 
Select the target platform: 
Pocket PC (PPC 2000), 
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Using Crunchit 



• Pocket PC 2002 (PPC 2002) or 

• Windows Mobile (PPC 2003) . 

3. Check the platforms (ARM, MIPS etc.) you want to target. Crunchit will gener- 
ate a file for each platform. Note that XScale processors use the ARM target. 

4. Tap the OK button. 

Crunchit will generate the self-extracting ZIP files in the same folder as the source 
ZIP file. It will append the platform name and ".exe" extension to the file. For 
example, app.zip will become appARM.exe or appSH3.exe. 



Creating uuencoded files 

If you want to send and receive binary files from news- 
groups or other Internet services, you will need to 
become familiar with uuencode. This format takes any 
file on your Pocket PC and produces an encoded (using 
only ASCII characters) version suitable for plain-text 
transport. 



To create a uuencoded file, select the UUEncode File 
option in the Tools menu: 

1. Tap the Browse button and select the source file. 

2. If the source file is too big (over 500K) to fit into a sin- 
gle message, select the Split ("Split file into multiple parts") option. See step 3. 

3. If you have selected the Split option, enter or select the maximum number of 
lines per message. You should enter atleast 10 lines. 

4. If you want to use base64 encoding, check the "Use base64 encoding" option. 

5. Tap OK to create the UUE file(s). 

Crunchit will generate a UUE file in the same folder as the source file. It will name 
files with the following convention: 

filename-extension[(part-total)].UUE 

The part-total information is present when the Split option is selected, otherwise it 
is omitted. 
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Source File 

Select the file to encode : 
|\My Domment^\Welcome To Windo| 
[ Browse... | 

-Options 

0 Split file into multiple parts 

Max lines ; | lOOO ^ 
0 Use base64 encoding 

[ Cancel | 



Hi" 
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Decoding files 



NOTE: The Windows CE (Pocket PC) operating system does not allow the forward 
slash character ('/') in filenames. 



Decoding files 
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Combine And Decode 

Select the file(s) to idecoide : 



Welcome To Windows Media-wma 



H 



\My Documents\ Welcome To Windo 



I ftdd... I 



Up 



To combine and decode files from newsgroups or 
email, select the Combine/Decode option in the 
Tools menu: 

1. Tap the Add button to select files to decode. 

2. To change the order of files, select the file- 
name in the listbox and use the Up and Down 
buttons. 

3. Tap OK to combine and decode the files. 



Cancel 
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CHAPTER 7 



Support 



To find current information on Cmnchlt, please monitor our website at: 

http://www.nsctech.com 
If you have purchased this software and require assistance, please contact: 

support@nsctech.com 
Sales and reseller information should be directed to: 

sales@nsctech.com 
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CHAPTERS Revision Notes 



Version 4.1 

• Fixed "My Device" folder in file dialogs; caused problems for some interna- 
tional users 

• Fixed bug in ZIP code that caused files in storage cards to fail 

• Added WM2003 ARM and X86 emulator self-extracting files 

• Updated SFX dialogs to select target platform 

• Fixed email support for PPC2002/2003 (pmail.exe changed to tmail.exe) 

• Crunchit source code is now running on all versions of Pocket PC and Windows 
CE.NET version 4.X (including Windows Mobile) 

• Added tar delete capabilities 

• Added tar long filename support 

• Updated User Guide 

• Allow SFX creation in trial version 
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Revision Notes 



Version 4. 0 

• added multi-select file dialogs 

• optimized file dialogs load/scroll speed 

• "compact view" file dialogs with color coding 

• updated password and find dialogs (new icon and layout) 

• find feature now available in trial 

• added uuencode (UUE) with base64 and multipart support 

• added uudecode (combine and decode) support 

• added current ZIP to SFX support 

• added current file to UUE support 

• optimized icon load and display 

• added masked password support 

• new "about" dialog to save storage 

• verified PPC 2003 OS support 



Version 3.5 

• added find feature 

• added SFX capabilities 

• changed default settings 

• update about dialogs 

• updated user documentation 

• new icons 

• optimized archive viewer 

• fixed sort icon in header control 



Version 3. 1 

• added benchmark prompt to general properties 
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Version 3.0 



• added performance counters to objects in CZipLib 

• added ZIP statistics for Anandtech tech website 

• tweaked view colors for LCD displays 



Version 3. 0 

• renamed to Crunchit 

• new list view control - faster and new color scheme/highlights 

• view compact file format 

• added GNU TAR (.tar) support 

• added GZIP (.gz, .tgz) support 

• added JAR (.jar) support 

• updated open file dialog 

• persistent file filter index 

• new menu bar 

• new menu bar icons 

• new application icon 

• modified new dialog to state "new zip" 

• added archive capabilities to ziplib 

• updated CInputStream code 

• modified password option to depend on archive capabilities 

• updated status dialog : cannot determine size of gzip output 

• updated properties dialog : cannot determine size of gzip output 

• new file properties dialog 

• updated installer : new neune emd new file formats 

• updated about 

• added all archives options to open file dialog 

• changed header control arrow 

• new listview sort code 

• fixed bug label bug in listview 
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Revision Notes 



• added file format/extension support to COpenDlg 

• fixed output file timestamps 

• added BZIP2 (.bz, .bz2, .tbz, .tb2) support 



Version 2. 0 

• multiple platform support (ARM/MIPS/SH3/XScale) 

• updated installer 

• fixed association name bug 

• 10% directory view speed increase 

• optimized file dialogs 

• refactored and optimized UI code 

• fixed bug in associated icon display 

• new verify code in settings pages 

• new trial dialog information 

• display unexpanded size 

• fixed compression ratio bug 

• updated user interface layout 

• bring up keyboard for new archive, password, comment, and new folder 

• clean-up new archive file logic 

• new multi-select feature (disables double chck and context menu) 

• new message handling in password dialog 

• fixed tool tip labels 

• fixed comment display in properties 

• updated edit comment function 

• added multi-select icon to toolbar 

• fixed move folder to archive bug 

• enhanced prompt for filename password 
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Version 1.1 

• 20% faster zip file and directory load/browse performance 

• fixed multiple selection bug 

• fixed display bug when laimched from explorer 

• fixed bug in PC installer 

• added wait cursor to long operations 

• refactored zip library and shell ui library code 

• moved password options to tools menu 

• changed 'double tap' input to open file 

• added mail file(s) feature 

• added open/launch file feature 

• added 'tap and hold' context menu for file operations 

• added select none option 



Notes 

The BZIP2 decompression algorithms used in this software are written by Juhan 
Seward. 
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